Explanation of the URI-Template

Short description of the URI-Template

URI-Templates are only used for REQUEST contacts (General Request / Abuse Contact). A URI-Template consists of a URI and optional variables.

In the case of a domain query (web-whois), the variables with the queried domain are replaced in the URI (URL or e-mail address).

URI-Template examples

Example with a URL:

A REQUEST contact contains the following URL with two variables for a URI-Template:

https://denic.de/contact/form?value1={Alabel}&value2={Ulabel}

The variables in the URL are enclosed in curly brackets and are DENIC's predefined variables for Alabel and Ulabel.

For a domain query (web-whois) with the example domain "beispiel-fünf.de", the domain is assigned to the variables as an ACE string and UTF-8 string:

  • Alabel := „xn--beispiel-fnf-mlb.de“
  • Ulabel := „beispiel-fünf.de“

In the URL, the variables are replaced with the strings:

https://denic.de/contact/form?value1=xn--beispiel-fnf-mlb.de&value2=beispiel-fünf.de

Example with an e-mail address:

For a REQUEST contact, with an e-mail address and a variable in the URI-Template, the variable is replaced in the case of a domain query (web-whois) with the example domain "beispiel-fünf.de".

Content URI-Template:

mailto:info@denic.de?subject=domain:{Ulabel}

Content variable:

Ulabel := „beispiel-fünf.de“

Ulabel is DENIC‘s predefined variable for domains represented as UTF-8 strings.

The variable is replaced with the string:

mailto:info@denic.de?subject=domain:beispiel-fünf.de

DENIC‘s rules for URI-Templates

  • The URI-Template can be up to 1024 characters long.
  • The URI schemas http, https and mailto are supported.
  • DENIC has predefined two variables for URI templates:
    • Alabel: Domain is displayed as an ACE string.
    • Ulabel: Domain is represented as UTF-8 string.
  • The variables are case-sensitive.
  • The variables are optional.
  • The use of other variables leads to an error.
  • Both variables can be used multiple times in the URI-Template.
  • The variables are replaced with the domain only for a domain query (web-whois).
  • For an RRI INFO query, the URI-Template is displayed with the variables.

NOTICE

DENIC only supports level 1 as described in the RFC 6570 - URI Template.